Add park list for Grouped Note Browsing and JSON Export - #13
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
park list, a read-only command that lists parked notes grouped by category with frontmatter-style output and a versioned--jsonenvelope for scripted consumers. Introduces a per-categoryexcludedflag so a category likearchivestays out of the default listing until explicitly requested.What's new
park list(aliasls) renders one banner per category, then one block per note showingfilename,category,created,source, andsynopsis, ordered oldest-modified first.-c, --categoryrestricts the listing to named categories (repeatable) and overrides exclusion;--allincludes categories excluded by config.--jsonemits a flat envelope of{schema_version, items}where each item carriesfilename,path,category,created,source,synopsis, and a UTC RFC 3339modified;schema_versiontracks the contract frompark schema.excludedboolean; the built-in IPAA config ships witharchiveexcluded.Usage
park listpark list --allpark list -c <category>park list --jsonBehavior changes / guardrails
--categoryoverrides the default exclusion and--all;--allonly widens the default selection.--categoryvalues exit 2 with the valid list, matchingpark newandpark reclassify.--jsonalways emitsitemsas an array, never null, and reports the folder-derived category so a stale frontmattercategorynever disagrees with the banner.excludedis encoded withomitempty, so non-excluded categories are unchanged inpark configoutput.park assistand the reclassify triage flow are unaffected.Testing
--allselection, explicit-category override, unknown category, empty-group omission, plain formatting, and the JSON envelope (version, fields, UTCmodified).list, aliasls,--all,--categoryoverride, unknown-category exit 2,--jsonparsing, and--json --categoryfiltering.excludedround-trip throughDump.make checkruns fmt, vet, lint, and tests; all green.